Skip to main content
Version: Next

Reporting Issues on the Rahat Platform

Rahat is an open-source platform, and we encourage contributors to help us improve it by reporting issues, whether they are bugs or enhancement suggestions. A well-documented issue helps our team and the community resolve problems efficiently.

πŸ“Œ What Types of Issues Can You Report?​

  • Bug Reports: Unexpected behavior, crashes, or broken features
  • Enhancements: Suggestions to improve existing features
  • New Feature Requests: Ideas that could enhance Rahat’s functionality

πŸ› οΈ How to Report an Issue?​

1. Check for Existing Issues​

Before reporting a new issue, please review the existing issues in the respective repository to ensure it hasn’t already been reported or is currently being addressed.

2. Create a New Issue on GitHub​

If your issue has not been reported yet:

  • Click on the β€œNew Issue” button located at the top right corner (green button)
  • You will be asked to choose the type of issue you want to create. Rahat provides three templates:
    • Bug Report – for reporting broken or malfunctioning features
    • Rahat Improvement Proposal – for suggesting changes or enhancements
    • Blank Issue – for reporting anything not covered above, or for writing issues from scratch

Choose the one that best fits your issue type.

3. Provide Key Details​

Each issue should include:

  • Clear and detailed descriptions with all necessary information
  • Steps to reproduce the issue (for bug reports)
  • Reasoning and impact for suggested improvements
  • Proposed solutions or ideas for implementation, if possible

Example:

Title: Bug: Incorrect token balance after transaction

Description:
Steps to reproduce:

  1. Navigate to the dashboard
  2. Send 10 tokens to another user
  3. Refresh the page

Expected result: Token balance should be updated immediately
Actual result: Token balance is not updating after the transaction
Environment: Rahat vX.Y.Z (specify version if possible)

4. Submit the Issue​

After filling in the details, submit the issue. Our team will review and respond accordingly.

πŸ’‘ Why Report Issues?​

Your contributions help shape Rahat! By reporting issues, you:

βœ… Drive Impact – Improve blockchain-powered humanitarian aid
βœ… Gain Recognition – Earn bounties & community shoutouts
βœ… Boost Your Skills – Sharpen debugging & problem-solving
βœ… Join the Community – Connect with innovators & experts

πŸš€ Every issue you report makes a difference!